home *** CD-ROM | disk | FTP | other *** search
/ E.M.Computergraphic Phase 1 / Phase 1 - EMC Computergraphic.iso / utilities / amidock / readme < prev    next >
Text File  |  1995-07-19  |  14KB  |  523 lines
  1.  
  2.  
  3.     AmiDock - version 1.3 - 03/10/91 by Gary Knight
  4.  
  5.  
  6.     What is AmiDock?  For those of you familar with the NeXT
  7.     computer this will be a short explanation. AmiDock is an Amiga
  8.     version of the NeXT's Dock.  AmiDock is (of course) more
  9.     versatile and  not as limited as it's NeXT cousin. 
  10.  
  11.     OK, now for those of you not familar with the NeXT computer.
  12.  
  13.     AmiDock will provide you with a number of buttons on the
  14.     WorkBench screen that when pressed will launch other programs.
  15.  
  16.     These buttons are fully configurable to run any program you want
  17.     with a single press.
  18.  
  19.     Here a a brief run down of the features of AmiDock:
  20.  
  21.      * AmiDock can run programs that need a CLI or the WorkBench.
  22.  
  23.      * AmiDock uses IFF brushes for the button imagery. The brushes
  24.        used are standard IFF files and can be customized to your
  25.        individual wants and desires.  In fact many of the programs
  26.        you will add to the dock will need a brush created for them. I
  27.        have included a Dock Image Grid for this purpose, but more
  28.        about that later.
  29.  
  30.      * AmiDock is compatible with WorkBench 1.2, 1.3, and 2.0 and
  31.        will run on any Amiga computer with any amount of memory.
  32.  
  33.        AmiDock has been tested on all Amiga machines:-
  34.  
  35.         (500/1000/2000/2500/3000).
  36.  
  37.      * Amidock supports an unlimited number of buttons. The buttons
  38.        are kept in a single line (column or row) and can extend
  39.        beyond the screen boundaries with the use of the two scroll
  40.        arrows.
  41.  
  42.      * AmiDock can be moved around the screen like any normal window,
  43.        and can be configured as a vertical column or a horizontal
  44.        row. 
  45.  
  46.  
  47.     Ok, now what do you need to get up and running with the program? 
  48.  
  49.      1) You will need a copy of the arp.library in your
  50.         LIBS: directory.  This has been included.  AmiDock uses the
  51.         arp.library for it's file requester.
  52.  
  53.      2) You will need to copy the AmiDock program to your
  54.         C: directory.
  55.  
  56.      3) Copy the Dock directory to your hard drive or your WorkBench
  57.         Boot Floppy. The Dock directory contains the following files
  58.         and directories:
  59.  
  60.                                    Page (1)
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.         INTERLACE
  70.  
  71.                      Dock/
  72.                      Interlace/
  73.                      DockImageGrid2.iff
  74.                      MainDock/
  75.                       <misc brush files>
  76.                        dock.config
  77.  
  78.         NON-INTERLACE
  79.  
  80.                      Non-interlace/
  81.                      DockImageGrid1.iff
  82.                      MainDock/
  83.                       <misc brush files>
  84.                        dock.config
  85.  
  86.      4) Lastly assign DOCK: to the directory where the configuration
  87.         file and the brushes are kept.  This will be either the
  88.         "Dock/Interlace/Maindock/" directory or the
  89.         "Dock/Non-Interlace/Maindock/" directory depending on if you
  90.         run your workbench in interlace mode or not.  The only
  91.         difference in the files are the size of the brushes.  The
  92.         interlace versions are larger than the non-interlace ones.
  93.  
  94.         Either one will work on any screen (interlaced or not).
  95.  
  96.         AmiDock when run from the workbench uses the DOCK: assignment
  97.         to find its config file and brushes. This assignment should
  98.         be added to your startup-sequence. AmiDock will also use the
  99.         DOCK: directory if run from the CLI with no argument given.
  100.  
  101.         The only argument AmiDock takes is the path to it's config
  102.         file.
  103.  
  104.      5) Execute AmiDock.
  105.  
  106.      6) AmiDock comes pre-configured to run a variety of programs.
  107.  
  108.         You will want to re-configure the dock to run the programs
  109.         you have.
  110.            
  111.            
  112.     Misc Stuff
  113.  
  114.     In this release the brushes associated with a given dock.config
  115.     file must be in the same directory as that dock.config file.  The
  116.     brush requester will allow you to enter a brush from a different
  117.     directory, but AmiDock will not recognize the brush if it is not
  118.     in the same directory as it's dock.config file.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                    Page (2)
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.     AmiDock does not need to be "run", it will set itself up as a
  136.     background process and return control to the CLI. AmiDock can be
  137.     added to your startup-sequence and it will allow the startup CLI
  138.     to close. If you are using AmigaDOS2.0, AmiDock can be placed in
  139.     the wbstartup drawer, just remember to add a tool type of
  140.     DONOTWAIT to AmiDock's icon.
  141.  
  142.     AmiDock accepts 1 argument when run from the CLI.  This is the
  143.     path to the config file and brushes.
  144.  
  145.     ex: amidock dh0:dock/interlace/maindock - this will use the path
  146.  
  147.         "dh0:dock/interlace/maindock" as the path to the config file.
  148.  
  149.     If AmiDock is run with no arguments it will use the
  150.     DOCK: assignment.
  151.  
  152.     The Text button in the Add/Edit/Delete window does not work.
  153.     (yet..)
  154.  
  155.     Pressing it will not cause any change in operation, AmiDock will
  156.     still use the brush.
  157.  
  158.     Included in this distribution should be two files called
  159.     "DockImageGrid1.iff" and "DockImageGrid2.iff". They are
  160.     non-interlaced and interlaced respectively.  These files are IFF
  161.     ILBM pictures of many pre-defined button image's and a bunch a
  162.     blank ones that you can fill in with your own designs. To create
  163.     a new brush or add a pre-defined one, load the DockImageGrid?.iff
  164.     into a paint program (DPaint), draw your new brush inside one of
  165.     the blank buttons or find a pre-defined you like, and grab it as
  166.     a brush. Make sure that the edges of the brush are the edges of
  167.     the button. Save the brush in the directory of the dock you want
  168.     to use it on. If you come up with any interesting brushes be sure
  169.     to upload them or mail them to me so I can include them with
  170.     future releases of AmiDock.
  171.  
  172.     I want to say a word of thanks to the management of Soft-Logik
  173.     Publishing Corp. for the use of their facilities in the
  174.     distribution of AmiDock.  While this is not in anyway a product
  175.     of Soft-Logik's they have nonetheless been very supportive of me
  176.     while I was developing it (by giving me a day job).  A special
  177.     thanks to Deron Kazmaier, Dan Weiss, Brad Kazmaier and
  178.     Mike Loader for their help in seeing AmiDock born.
  179.  
  180.     Last but not least, AmiDock is a shareware program. AmiDock is
  181.     not Public Domain or Freeware. AmiDock is freely re-distributable
  182.     providing all the files in this distribution are kept intact.
  183.  
  184.     Please give (do not sell) AmiDock to anyone you like. As stated,
  185.     AmiDock is a shareware program and as such I request a fee of
  186.     $25.00 if you use this program. 
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                                    Page (3)
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.     When I receive your monetary contribution I will make you a
  202.     registered user and send you a "real" manual that explains in
  203.     greater detail the workings of AmiDock and the latest version of
  204.     the program. As a registered user you will be entitled to free
  205.     upgrades (via on-line services) as long as AmiDock remains a
  206.     shareware product and a discount if (and hopefully when) AmiDock
  207.     goes commercial.  If you are registered and would like a copy of
  208.     the latest version from me, just send a blank floppy and a SASE
  209.     that can hold the floppy, and I will send you the latest free of
  210.     charge. I have big plans for AmiDock, but they will only be
  211.     realized if the product gets support from the Amiga community.
  212.  
  213.     Well that's about all for the readme file. A complete description
  214.     of the program and all it's features will be supplied in the
  215.     manual which you will receive when you send in your registration
  216.     card (see below) and money. Please mail the card and your payment
  217.     (check (drawn on a US bank), money order payable to me (in U.S.
  218.     Funds), or cash) at the address listed below:
  219.  
  220.  
  221.                         
  222.      Gary Knight
  223.      3200 Patterson Place Dr #307
  224.      St.Louis, Mo. 63129
  225.  
  226.  
  227.     I hope you find this program useful!  If you have any comments or
  228.     bug reports I can be reached by e-mail on:
  229.  
  230.      GENIE: Deron.K
  231.      CIS: 76317,3633
  232.      BIX: dkazmaier
  233.      Soft-Logik BBS: Quill, or #292
  234.  
  235.     You can also drop me a letter at the address listed above.
  236.  
  237.     Thank You!!!!
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                    Page (4)
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.     PS: Here is a list of the new features/fixes in AmiDock 1.4.1:
  268.         (which you will receive when you register)
  269.                 
  270.     - added support for drop in icons under wb2.0. To add a new item
  271.       just drag the icon over to the dock and drop it on the dock's
  272.       window and it will be added using the icon for an image.
  273.         
  274.     - now it uses GetDiskObject to load the icon's imagery instead
  275.       of reading the file directly.
  276.           
  277.     - bug fixes involving memory not being freed under some
  278.       conditions.
  279.         
  280.     - added support for using icons for bay images.
  281.         
  282.     - added support for using text for bay images (including font
  283.       and color control if running under wb2.0).
  284.         
  285.     - some internal re-works, code cleanup, and optimizations.
  286.         
  287.     - eliminated all need for the arp.library if running under wb2.0!
  288.       (and there was much rejoicing)
  289.           
  290.       * AmiDock uses the ASL file requester.
  291.       * AmiDock uses the ASL font requester.
  292.       * AmiDock uses the DOS Execute() call when running a program as
  293.         a CLI style process.
  294.         
  295.     - when AmiDock is the active window the WB screen title bar now
  296.       has the word "AmiDock" in it. (this goes for the select and
  297.       edit windows also)
  298.         
  299.     - when AmiDock is launching a program it puts a message in the WB
  300.       screens title bar that reads "Attempting to load 'program
  301.       name'..." like wb2.0.
  302.           
  303.     - the prop gadget in the Dock Item Selector window now uses the
  304.       PROPNEWLOOK flag for the new and improved wb2.0 look.
  305.           
  306.     - put in much more comprehensive error handling and reporting.
  307.         
  308.     - if the icon image is used, the name of the ".info" file is
  309.       taken from the path+appname+".info". It no longer uses the
  310.       string gadget's contents to get the ".info" file.
  311.           
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.                                    Page (5)
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.     How to use AmiDock
  334.                         
  335.     There are two ways to use AmiDock:
  336.  
  337.     1) From the the CLI enter 'amidock' and the prompt and press
  338.        return.
  339.  
  340.        This will cause AmiDock to look in the DOCK: directory that
  341.        you assigned before you ran AmiDock (usually in your
  342.        startup-sequence).
  343.  
  344.        AmiDock will also use the DOCK: assignment if you ran it
  345.        from the WorkBench by double clicking on its icon, or under
  346.        WB2.0, placing it in the WBStartup drawer.
  347.     
  348.        The assign DOCK: must be made so that it specifies a directory
  349.        where a dock.config file is located and must be done before
  350.        you run amidock in this way.
  351.     
  352.          example: assign DOCK: dh0:dock/interlace/maindock
  353.     
  354.        For this example to work a dock.config file must be in the
  355.        directory 'dh0:dock/interlace/maindock'.
  356.     
  357.     2) The second way to run AmiDock eliminates the need for the
  358.        Assign DOCK: stuff.  All that you need to do is to give the
  359.        path to the dock.config file as the first argument to AmiDock
  360.        when you run it from the CLI.  This method only works from a
  361.        CLI (or shell). It will not work from he WorkBench, to run
  362.        AmiDock from the WorkBench see #1 above.
  363.    
  364.         example: amidock dh0:dock/interlace/maindock
  365.    
  366.        Remember a dock.config file must be in the directory
  367.        dh0:dock/interlace/maindock
  368.    
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.                                    Page (6)
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.     NEW for version 1.4:
  400.  
  401.     When you run AmiDock and it cannot find a dock.config file
  402.     AmiDock will put up a error message stating that it cannot find
  403.     its dock.config file.  If this happens be sure that the
  404.     dock.config file is in the directory specified as a argument or
  405.     by the assignment DOCK:.
  406.  
  407.     To run AmiDock from the startup-sequence add the following lines
  408.     to your startup-sequence:
  409.  
  410.      assign DOCK: <path to dock.config file - see above>
  411.      amidock.
  412.  
  413.     To run more than one AmiDock from your startup-sequence add these
  414.     lines:
  415.  
  416.      assign DOCK: <path to dock.config file - see above>
  417.      amidock
  418.      amidock <path to another dock.config file>
  419.  
  420.  
  421.     You can run as many as you want to like this, just remember that
  422.     each different AmiDock needs its own dock.config file (put them
  423.     in separate directories) and each brush used by a particular dock
  424.     needs to be located with each and every dock.config file that
  425.     uses it.
  426.  
  427.     TEXT ENDS...
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.                                    Page (7)
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                         cut here and return with payment
  466.     -----------------------------------------------------------------
  467.  
  468.  
  469.                              USER  REGISTRATION  CARD
  470.  
  471.  
  472.     Product: AmiDock v1.3
  473.  
  474.  
  475.     Name:    _________________________________________________________
  476.  
  477.     Address: _________________________________________________________
  478.  
  479.     City:    __________________________________ State:________________
  480.  
  481.     Country: _________________________ Postal Code:___________________
  482.         
  483.  
  484.     Workbench version:________________________________________________
  485.         
  486.         
  487.     Description of Hardware:__________________________________________
  488.  
  489.     __________________________________________________________________
  490.  
  491.  
  492.     Primary Use of Hardware:  ___ Home ___ Business ___ Fun ___ Other
  493.  
  494.     
  495.     Comments:_________________________________________________________
  496.  
  497.     __________________________________________________________________
  498.  
  499.     __________________________________________________________________
  500.  
  501.     __________________________________________________________________
  502.  
  503.     __________________________________________________________________
  504.     
  505.     __________________________________________________________________
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.                                    Page (8)
  523.